1.4 Installation de Git

La première étape consiste à installer Git sur votre ordinateur.

Cela se fait très simplement quelque soit le système d’exploitation de votre machine. Il suffit de suivre les instructions parfaitement détaillées en français sur la page d’installation de Git

1.5 Création d’un compte Github

Cette première étape est un passage obligé. Si ce fonctionnement peut faire, à raison, penser à un réseau social rassurez-vous les règles de la propirété intellectuelle sont très claires, et vous choisirez les projets à rendre publics ou privées, ainsi que les collaborateurs à éventuellement inviter.

La création d’un compte se fait de manière tout à fait classique:

1. Rendez-vous sur le site de Github
2. Cliquez sur sign up en haut à droite
3. Remplissez les champs demandés

1.6 Créer un nouveau dépôt Github

Une fois connecté à Github vous arrivez sur la page de votre profil.

Pour créer un dépot² rendez-vous sur la section Repositories via le bandeau.

Cette page recence tous les répertoires associés à votre compte, si vous venez de vous créer un compte, elle devrait donc être vide, sinon vous retrouverez ici tous vos différents dépôts. Pour en créer un, il suffit de cliquer sur new.

C’est sur cette page à laquelle vous venez d’accéder après avoir cliqué sur new que vous allez véritablement créer votre nouveau dépôts : lui donner un nom, déterminer son statut privé ou public…

Après avoir cliqué sur Create repository vous aurez donc crée avec succès un nouveau dépôt Github. Vous verrez cette nouvelle page s’afficher. Elle vous orientera vers différentes marche à suivre. Par ailleurs, cette page vous fournis en grande partie les lignes de commande et les informations que nous allons utilisé pour remplir votre répertoire.

1.7 Importer des élements dans votre répertoire Github depuis votre ordinateur

Pour réaliser cet import, nous allons temporairement laissé Github de côté. Vous avez donc réaliser en local votre fiche Rzine, et disposez d’un dossier contenant tous les différents éléments. L’objectif est donc d’importer facilement ce dossier (dans son intégralité) dans votre répertoire. Pour ce faire nous allons utilisé git et ses lignes de commande basique.

1- Il vous faut en premier lieu ouvrir votre terminal ou invite de commande

C’est la façon la plus efficace d’intéragir avec Github depuis votre ordinateur. Cette interface, si on est pas habitué peut effectivement rebuté, mais l’apprentissage pour réaliser certaines opérations basiques se fait rapidement. En revanche, chaque système d’exploitation possède sa propre interface en ligne de commande :

• Windows : l’invite de commande. Celle-ci peut être lancée en utilisant la touche Windows et en tapant Invite de commande (ou cmd) avant de sélectionner l’option dans la liste qui apparaît.

• MacOS : le terminal. On le trouvera dans Applications > Utilitaires.

• Linux : Généralement, on peut lancer un terminal avec le raccourci clavier Ctrl + Alt + T. Si cela ne fonctionne pas, recherchez Terminal dans les applications ou via les outils de recherche.

Voici à quoi ressemble un terminal :

2- Nous allons maintenant nous placer dans le dossier au sein duquel vous avez enregistré votre projet que vous souhaitez importer. Pour ce faire nous utiliserons cette ligne de commande

cd "chemin/vers/votre/dossier"

Il faudra bien sur remplacer le chemin entre "" par le chemin correspondant à votre dossier sur votre ordinateur.

3- Il faut ensuite lancer Git :

git init

Cette commande permet d’initialiser Git dans le dossier au sein duquel vous vous trouvez, cela implique que toutes les opérations que vous réaliserez avec Git dans ce dossier seront sauvegardés.

4- Une fois git initialisé, il faut lui indiquer l’URL du dépôt Github au sein duquel vous souhaitez importer vos fichier et dossier.

git remote add origin https://github.com/LeCampionG/github_fiche_rzine.git

Cette url est celle indiqué dans la barre d’adresse de votre navigateur lorsque vous êtes connecté à Github et dans votre dépôt. Elle est également indiqué dans les premières informations affichées lorsque vous avez créée votre dépôt.

5- Nous indiquons maintenant ce que nous souhaitons envoyer, importer dans notre dépôt

Cela se fait en plusieurs étape. D’abord spécifier les fichiers à envoyer.

Pour importer l’intégralité du dossier nous utiliserons la commande :

git add --all

Une fois avoir précisé les éléments à transfèrer nous allons devoir réaliser un commit³. Avec cette commande nous allons réalisé un instantané (au sens photographique) des fichiers sur lesquels nous travaillons. Il s’agit en fait d’une sauvegarde à un instant “t” des différents éléments du dossier.

git commit -m "1er import des fichiers"

-m "un_texte" permet simplement d’expliciter l’action, en l’associant à un message, une description.

6- La dernière étape consiste à rendre tout cela visible et accessible, on parle de pusher⁴ les fichiers :

git push -u origin master

master correspond à l’endroit où nous allons envoyé nos fichiers.

Pour valider votre import, il faudra fournir votre identifiant et votre mot de passe

Votre dépôt contient désormais les fichiers que vous aviez en local sur votre ordinateur.

1.8 Les branches

Git et Github permettent de faire des branches⁵ Cela s’avère très utile lorsque l’on travaille à plusieurs ou que des corrections sont nécessaires.

Dans Gitub, la création de branches peut se faire facilement. Depuis l’acceuil de votre dépôt (onglet <> code) cliquez sur le bouton encadré en rouge, dans l’image ci-dessous. Ce bouton permet entre autre de créer des branches.

Un menu déroulant apparait, pour créer une branche il suffit d’écrire son nom puis de cliquer sur Create branch.

Cet onget vous indiquera dans quelle branche vous vous trouvez mais également de naviguer entre vos branches.

En procédant de cette manière, les branches créee seront des copies des branches depuis lesquelles vous les avez produites. Cela suppose que s’il y a des modification à faire il faut les faire depuis Github ou supprimer un fichier et le ré-importer dans la branche. Ce n’est pas toujours le plus efficace.

La même chose est possible en ligne de commande, et ceux de manière plus optimiser (même si, nous aborderons pas ici toute la compléxité et les possibilités de la création de branche avec les fonctions Git).

Pour faciliter la compréhension du principe prenons l’exemple de notre fiche Rzine. Nous avons déposer dans notre dépôt Github une première version de nos travaux. Nous souhaitons la faire relire par un collègue, ou y apporter nous même des modifications sans toutefois écraser notre première version. Nous allons donc opérer les différentes modifications en local sur notre ordinateur. Une fois satisfait, nous allons créer une branche au sein de laquelle nous allons importé nos fichiers modifiés sans écrasé nos premiers travaux. Le très grand intérêt à cela c’est que nous pourrons par la suite comparer les deux branches et éventuelement les fusionner.

Commencez par vous placer dans le bon répertoire. Nous retournous dans notre dossier :

cd "/mnt/9A8C6DB98C6D9115/gregoire/Rzine/tuto_github"

Pour créer une nouvelle branche il suffit de d’écrire :

git checkout -b correction

Nous avons donc ici créée et basculé vers une nouvelle branche appelée correction.

Et nous pouvons, de la même manière que nous l’avons fait pour la branche principale de notre dépôt, importer un fichier ou des dossiers dans cette branche nouvellement créée.

Attention, il est nécessaire d’indiquer à Git quel fichiers ont été retravaillés

git add rzine_tuto_github.Rmd

La commande git status peut être très pratique pour avoir un aperçu des fichiers qui ont subi des modifications.

Comme précédemment, il faut réaliser un commit, qui permetra notamment de voir et prendre en compte toutes les modifiations qui ont été faites

git commit -m 'fichier sur lequel réaliser modifications'

Et enfin, on envoit effectivement sur notre branche de notre dépôt :

git push origin correction

Pour retourner sur une autre branche, par exemple la branche master

git checkout master

1.9 Pull requests

Avec la création de branches vous pouvez modifier comme vous le souhaitez un fichier tout en le conservant intact dans une autre branche. Cependant, une fois les corrections, les modifications… terminées il peut être utile de comparer les différents élément et fusionner les fichiers modifiés. On peut alors réaliser une pull requests.

Github propose une interface graphique intéressante pour réaliser cette opération (elle est bien évidemment aussi faisable en ligne de commande). Pour se faire utilisez le bandeau et rendez-vous dans la section Pull requests.

Cliquez sur New pull request pour lancer une nouvelle comparaison:

Il faut désormais choisir les deux branches à comparer :

Une fois fait, vous verrez les différences éventuelles entre vos deux branches : les modifications des fichiers similaires, les fichiers présents dans la 2ème branche mais pas la première…

Si cela vous convient, cliquez sur le bouton Create pull request.

Vous pouvez ensuite commenter, décrire votre demande et la soumettre en cliquant sur Create pull request.

Vous avez donc fait une demande qui apparaitra dans votre section Pull requests.

Vous pouvez echanger de la manière qu’avec les issues, mais surtout visualiser les ce qui sera fusionner. Si cela vous convient vous pouvez accepter les modifications vous pouvez cliquer sur Merge pull request ou au contraire refuser et cliquer sur Close pull request.

Les deux branches seront alors fusionner.